home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: MegaDisc / MegaDisc 06 (1988)(MegaDisc Digital Publishing)(AU)[m][WB].zip / MegaDisc 06 (1988)(MegaDisc Digital Publishing)(AU)[m][WB].adf / PROGRAMS / PrinText.Doc < prev    next >
Text File  |  1988-03-27  |  10KB  |  243 lines
  1.                  PRINTEXT v1.5  Documentation      by Opher Dan Kahane
  2. ----------------------------------------------------------------------------
  3.                                                                
  4.  
  5.  
  6. -----------------
  7. What is PrinText?
  8. -----------------
  9.  
  10.  PrinText is a program to display ASCII text files on the screen. Instead of
  11. using the 'type' command in the CLI for reading text files, you can use
  12. PrinText. PrinText includes scrollbar and arrow gadgets, automatic word-wrap,
  13. a search function, speech, IFF picture loading, text file printing and online
  14. help.
  15.  
  16.  PrinText 1.5 MUST be used with Kickstart 1.2/Workbench 1.2!
  17.  
  18.  
  19. -----------
  20. What's new?
  21. -----------
  22.  1)  PrinText now uses Darren M. Greenwald's FastText() routines to achive
  23.      MAJOR speed improvement in text output. When a text file is loaded,
  24.      the screen just appears! Want to see how fast it goes? Load a long
  25.      text file, then hold down the Right-Amiga-D key (Scroll down one page).
  26.      PrinText will SPEED through the pages at an amazing rate!!!
  27.      Thanks to Darren for placing his routines in the public domain. You've
  28.      done a GREAT job, Darren!!! 
  29.      
  30.  2)  A print function has been added. Now you can print text files from within
  31.      PrinText, just by choosing the file from a file-requester.
  32.  
  33.  3) PrinText works fine with expansion memory. I just got my own 2 Meg
  34.     expansion unit, so now I can test it myself.
  35.  
  36.  4) Now you don't have to click in the File name & Directory name gadgets in
  37.     order to select them. They are automaticaly selected for you.
  38.  
  39.  5) A bug in the IFF loader has been fixed: Sometimes the displayed colors were
  40.     wrong. It's Okay now.
  41.  
  42.  PrinText may be freely distributed on Public BBS's, Networks, User Groups,
  43. AMICUS disks & Fred Fish disks only. No payment should be charged for it,
  44. except for a minimum media and Handling/Shipping fee. It may NOT be distributed
  45. in any way without prior written permission from the writer of this program.
  46.  
  47.  This Documentation file and the icons MUST accompany the executable program.
  48.   
  49.  PrinText is not a public domain program, it is a Shareware program. This
  50. means that you can copy it to your friends, and if you find it useful please
  51. donate a respectable amount of money to your local Homeless-Help fund or any
  52. similar organization. Remeber, YOU CAN do something to help other people.
  53. Now the only problem is, DO YOU WANT TO?!?
  54.  
  55.  I hope that you are honest enough to do that, aren't you? If not, ERASE
  56. PrinText from your disk. (HONESTY IS VERY RARE NOWDAYS, AIN'T IT?)
  57.  
  58.  
  59.  Thanks, and enjoy the program!
  60.  
  61.  
  62.            Suggestions, questions and bug reports are welcome.
  63.  
  64.  My address is :
  65.                          Opher D. Kahane
  66.                          30 Gilboa St.
  67.                          Alfe Menashe 48851
  68.                          Israel
  69.                          Phone #: 052-925167
  70.  
  71.    /-----------------------------------------------------------------\
  72.    | SURGEON GENERAL'S WARNING:    Keeping ShareWare programs without |
  73.    | sending a donation is risky to your conscience and may result in |
  74.    | trauma, depression, and loss of self confidence.                 | 
  75.    \_________________________________________________________________/
  76.  
  77.  
  78. ---------------------------
  79. Using Printext from the CLI
  80. ---------------------------
  81.  
  82.  The CLI syntax for PrinText is "PrinText [<filename>]". This means that you
  83. can load PrinText by typing "PrinText" , or by typing 'PrinText' followed
  84. by a filename. For example, typing "PrinText myfile.txt" will load PrinText,
  85. and display the text file "myfile.txt".
  86.  
  87.  If you do not supply a filename, a file requester will appear as soon as
  88. PrinText is loaded. You can type in the name of the file you want to read,
  89. then click on the OK gadget to load the file. You can also click on any of the
  90. files which appear in the directory. If you want to change the current 
  91. directory, just type in in the drawer gadget, or click on any of the 
  92. "device" gadgets - df0:, df1:, ram:, and dh0: (for a hard drive).
  93.  
  94. -----------------------------
  95. Using PrinText from Workbench
  96. -----------------------------
  97.  
  98.  To load PrinText from Workbench, double click on the PrinText icon. When
  99. PrinText loads, a requester will appear. Type in the name of the file you
  100. want to load, then click on the LOAD gadget. Clicking on the QUIT gadget
  101. will exit the program without loading the file.
  102.  
  103.  If the text file you want to read has an icon, you can click once on its
  104. icon, press the SHIFT key on the keyboard, and while holding it down, double
  105. click on the PrinText icon. This will load PrinText, and PrinText will load
  106. the text file automatically.
  107.  
  108.  If the default tool of the text file you want to load is set to PrinText,
  109. you can  double click on the icon of the text file, and this will load
  110. PrinText and the text file automatically.
  111. To set a file's default tool to PrinText, do the following:
  112.  
  113. a. Click once on the icon of the text file.
  114. b. Choose INFO from the Workbench menu. This will display the icon's data on
  115. the screen.
  116. c. Click in the 'Default tool' text gadget, and type in "PrinText".
  117. d. Click on the SAVE gadget, and that's all!
  118.  
  119.  
  120.  
  121.  
  122. -------------------------
  123. Using the SEARCH function
  124. -------------------------
  125.  
  126.  Double clicking the RIGHT mouse button will cause the Search requester to
  127. appear. Click inside the text gadget, and type in the word you want to find
  128. (It can also be a phrase or a sentence). You can also choose 'Search' from
  129. Project menu.
  130.  
  131.  To start the search, just click on the SEARCH gadget. When an occurrence of
  132. the word is found, it will be highlighted in red. A requester will appear,
  133. asking if you want to go on with the search or stop it. Click on the CANCEL
  134. gadget to stop the search.
  135.  
  136.  PrinText will search for the given phrase from the first line displayed on
  137. the screen to the end of the file. This means that if the last page is
  138. displayed, the phrase will be searched for only in that page. If the top of
  139. the file is displayed, the whole file will be searched.
  140.  
  141.  If the word is not found, a requester will appear. Click on the 'GO ON'
  142. gadget to continue.
  143.  
  144.  There are two search modes, Simple and Smart. To toggle the mode, click on
  145. the gadget between the SEARCH and CANCEL gadgets.
  146.  
  147.  In the SIMPLE search mode, PrinText will look for the word EXACTLY as you
  148. typed it in. If you type in the word 'Amiga', PrinText will not consider the
  149. words 'amiga' , 'AMIGA' or 'AmIgA' equal to it.
  150.  
  151.  In the SMART search mode, PrinText will look for words that spell the same
  152. as the word you typed in, even if the case of the word is different. So if
  153. you type in the word 'ATARI' (please don't do that) , PrinText will consider
  154. 'atari', 'AtarI' and 'Atari' equal to it.
  155.  
  156.  
  157. ----------------------
  158. Loading an IFF picture
  159. ----------------------
  160.  
  161.  To load an IFF picture (any DPaint, Aegis Images, Graphicraft or Digiview
  162. picture), choose 'Load IFF' from the Project menu or press Right-Amiga I.
  163. A file requester will appear: Click inside the text gadget and type in the
  164. filename, then click on the OK gadget. You can also click on any of the files
  165. in the directory. 
  166. PrinText will load the picture and display it. To go back to PrinText click the 
  167. RIGHT mouse button.
  168. PrinText supports all of the graphics modes of the amiga including HAM (with
  169. up to 4096 colors on the screen) and Interlace.
  170.  
  171.  
  172. ------
  173. Speech
  174. ------
  175.  
  176.  PrinText can read you the whole text file at once or one page at a time.
  177. Choose 'Read all' from the project menu to activate the speech. PrinText
  178. will scroll the text so that the line being read is always the first line on
  179. the screen. The scrolling will stop at the last page.
  180.  
  181.  To read the current page only, click on the "lips" gadget. This time the
  182. screen will not be scrolled.
  183.  
  184.  To stop the reading, click on the "lips" gadget, located to the left of the
  185. depth arrangement gadgets. The reading will stop as soon as the end of the
  186. line being read is reached.
  187.  
  188. ------------------------
  189. Using the Print function
  190. ------------------------
  191.  
  192.  To print a text file, pick the 'Print' option from the Project menu. Choose
  193. a file from the file-requester (By either typing in a path and filename, or 
  194. clicking on the wanted file). Click on the OK gadget to print the file, or 
  195. the CANCEL gadget to abort. PrinText will NOT print the file being displayed
  196. on the screen since it has been modified in the loading process. (If you do
  197. want to print the current file, just choose it from the file-requester)
  198. There are no means of stopping the print process (From within PrinText, that
  199. is) once it has began.
  200.  
  201.   
  202. ------------------------
  203. Command and menu summary
  204. ------------------------
  205.  
  206.  Here is the summary of the menu options, and the command keys.
  207. The letter before the menu option is the command key. To use it instead of
  208. using the mouse, press Right-Amiga and the command key together.
  209.  
  210. Project menu:
  211. ------------
  212.  
  213. A, About - Display help page.
  214. L, Load -  Load a text file.
  215. R, Read all - Read the text file.
  216. S, Search - Search for a word.
  217. I, Load IFF - Load an IFF picture file.
  218. P, Print a text file.
  219. Q, Quit - Exit the program. You can click on the close gadget instead.
  220.  
  221.  
  222. Colors menu:
  223. -----------
  224.  
  225.  Here you can choose the color of the text and the background.
  226.  
  227.  
  228. Movement menu:
  229. ------------
  230.  
  231. T, Goto top - Display the first screen of the file.
  232. B, Goto buttom - Display the last screen of the file.
  233. U, Page UP -  Display previous screen.
  234. D, Page DOWN - Display next screen.
  235. Z, Line UP - Move up one line.
  236. X, Line DOWN - Move down one line.
  237.  
  238.  If you hold down the Right-Amiga Z or Right-Amiga X, PrinText will quickly
  239. scroll through the file.
  240.  
  241.                      
  242. ~~~~~~~~~~~~~~~~~~~~~~~~~~ END OF PRINTEXT.DOC ~~~~~~~~~~~~~~~~~~~~~~~~~~
  243.